'\" t
.\"     Title: SCONSIGN
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
.\"      Date: 11/03/2016
.\"    Manual: SCons 2.5.1
.\"    Source: SCons 2.5.1
.\"  Language: English
.\"
.TH "SCONSIGN" "1" "11/03/2016" "SCons 2\&.5\&.1" "SCons 2\&.5\&.1"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sconsign \- print SCons \&.sconsign file information
.SH "SYNOPSIS"
.HP \w'\fBsconsign\fR\ 'u
\fBsconsign\fR [\fIoptions\fR...] \fIfile\fR [\fI\&.\&.\&.\fR]
.SH "DESCRIPTION"
.PP
The
\fBsconsign\fR
command displays the contents of one or more
\fB\&.sconsign\fR
files specified by the user\&.
.PP
By default,
\fBsconsign\fR
dumps the entire contents of the specified file(s)\&. Each entry is printed in the following format:
.PP
file: signature timestamp length implicit_dependency_1: signature timestamp length implicit_dependency_2: signature timestamp length action_signature [action string]
.PP
\fBNone\fR
is printed in place of any missing timestamp, bsig, or csig values for any entry or any of its dependencies\&. If the entry has no implicit dependencies, or no build action, the lines are simply omitted\&.
.PP
By default,
\fBsconsign\fR
assumes that any
\fIfile\fR
arguments that end with a
\fB\&.dbm\fR
suffix contains signature entries for more than one directory (that is, was specified by the
\fBSConsignFile ()\fR
function)\&. Any
\fIfile\fR
argument that does not end in
\fB\&.dbm\fR
is assumed to be a traditional
\fB\&.sconsign\fR
file containing the signature entries for a single directory\&. An explicit format may be specified using the
\fB\-f\fR
or
\fB\-\-file=\fR
options\&.
.SH "OPTIONS"
.PP
Various options control what information is printed and the format:
.PP
\-a, \-\-act, \-\-action
.RS 4
Prints the build action information for all entries or the specified entries\&.
.RE
.PP
\-c, \-\-csig
.RS 4
Prints the content signature (csig) information for all entries or the specified entries\&.
.RE
.PP
\-d DIRECTORY, \-\-dir=DIRECTORY
.RS 4
When the signatures are being read from a
\fB\&.dbm\fR
file, or the
\fB\-f dbm\fR
or
\fB\-\-format=dbm\fR
options are used, prints information about only the signatures for entries in the specified
\fIDIRECTORY\fR\&.
.RE
.PP
\-e ENTRY, \-\-entry=ENTRY
.RS 4
Prints information about only the specified
\fIENTRY\fR\&. Multiple \-e options may be used, in which case information about each
\fIENTRY\fR
is printed in the order in which the options are specified on the command line\&.
.RE
.PP
\-f FORMAT, \-\-format=FORMAT
.RS 4
The file(s) to be printed are in the specified
\fIFORMAT\fR\&. Legal values are
\fBdbm\fR
(the DBM format used when the
\fBSConsignFile\fR() function is used) or
\fBsconsign\fR
(the default format used for an individual
\fB\&.sconsign\fR
file in each directory)\&.
.RE
.PP
\-h, \-\-help
.RS 4
Prints a help message and exits\&.
.RE
.PP
\-i, \-\-implicit
.RS 4
Prints the list of cached implicit dependencies for all entries or the the specified entries\&.
.RE
.PP
\-\-raw
.RS 4
Prints a pretty\-printed representation of the raw Python dictionary that holds build information about individual entry (both the entry itself or its implicit dependencies)\&. An entry\*(Aqs build action is still printed in its usual format\&.
.RE
.PP
\-r, \-\-readable
.RS 4
Prints timestamps in a human\-readable string, enclosed in single quotes\&.
.RE
.PP
\-t, \-\-timestamp
.RS 4
Prints the timestamp information for all entries or the specified entries\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
Prints labels identifying each field being printed\&.
.RE
.SH "ENVIRONMENT"
.PP
SCONS_LIB_DIR
.RS 4
Specifies the directory that contains the SCons Python module directory (e\&.g\&. /home/aroach/scons\-src\-0\&.01/src/engine)\&. on the command line\&.
.RE
.SH "SEE ALSO"
.PP
\fBscons\fR,
\fBscons\fR
User Manual,
\fBscons\fR
Design Document,
\fBscons\fR
source code\&.
.SH "AUTHORS"
.PP
Steven Knight <knight at baldmt dot com>
